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Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The present document is part the 32.300-series covering the 3''' Generation Partnership Project: Technical Specification 
Group Services and System Aspects; Telecommunication Management; Notification Management, as identified below: 

32.301: "Notification Integration Reference Point: Requirements"; 

32.302: "Notification Integration Reference Point: Information Service Version 2"; 

32.303: "Notification Integration Reference Point: CORBA Solution Set Version 2:1"; 

32.304: "Notification Integration Reference Point: CMIP Solution Set Version 2:1"; 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 

Configuration Management (CM), in general, provides the operator with the ability to assure correct and effective 
operation of the 3G network as it evolves. CM actions have the objective to control and monitor the actual configuration 
on the Network Elements (NEs) and Network Resources (NRs), and they may be initiated by the operator or by 
functions in the Operations Systems (OSs) or NEs. 

CM actions may be requested as part of an implementation programme (e.g. additions and deletions), as part of an 
optimisation programme (e.g. modifications), and to maintain the overall Quality Of Service (QOS). The CM actions 
are initiated either as a single action on a NE of the 3G network or as part of a complex procedure involving actions on 
many NEs. 

The Itf-N interface is built up by a number of Integration Reference Points (IRPs) and a related Name Convention, 
which realise the functional capabilities over this interface. The basic structure of the IRPs is defined in 
3GPP TS 32.101 [5] and 3GPP TS 32.102 [6]. 

Network Elements (NEs) under management and element managers generate notifications of events about occurrences 
within the network. Different kinds of events carry different kinds of information. For instance a new alarm as 
specified in Alarm IRP: Information Service [1], is one possible kind of event, an object creation as specified in Basic 
CM IRP: Information Service [8] is another possible kind of event. 

Information of an event is carried in notification. An IRP Agent (typically an EM or a NE) emits notifications. 
IRPManager (typically a network management system) receives notifications. The purpose of Notification IRP is to 
define an interface through which an IRPManager can subscribe to IRP Agent for receiving notifications. 
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This IRP bases its design on work captured in ITU-T Recommendation X.734 [2], OMG Notification Service [4]. The 
central design ideas are: 

• Separation of notification Consumers (IRPManagers) from Producers (IRP Agents); 

• Notifications are sent to IRPManagers without the need for IRPManagers to periodically check for new 
notifications. 

Common characteristics related to notifications in all other IRPs are gathered in one IRP. 
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Scope 



The present document specifies the Common Object Request Broker Architecture (CORBA) Solution Set (SS) for the 
IRP whose semantics is specified in Notification IRP: Information Service [5]. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[I] ITU-T Recommendation X.736: "Security Alarm Reporting Function". 

[2] OMG TC Document telecom (98-11-01): "OMG Notification Service". 

[3] OMG CORBA services: Common Object Services Specification, Update: November 22, 1996. 

(Clause 4 contains the Event Service Specification.) 

[4] 3GPP TS 32.312: "Generic IRP Management: Information Service". 

[5] 3GPP TS 32.302: "Notification IRP: Information Service". 

[6] 3GPP TS 32. 111-2: "Alarm IRP: Information Service". 

[7] 3GPP TS 32.101: "3G Telecom Management principles and high level requirements". 

[8] 3GPP TS 32.102: "3G Telecom Management architecture". 

[9] 3GPP TS 32.301: "Notification IRP: Requirements". 

[ 1 0] 3GPP TS 32. 1 1 1 -3 : "Alarm IRP: CORBA Solution Set". 

[II] 3GPP TS 32.3 1 1 : "Generic IRP Management: Information Service" 



Definitions and abbreviations 



3.1 Definitions 

For the purposes of the present document, the following terms and definitions apply. Please refer to 3GPP TS 32.10 
[7], 3GPP TS 32.102 [8] and 3GPP TS 32.301 [9]. 

• IRP document version number string (or "IRP Version"). See 3GPP TS 32.31 1 [11]. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 
CM Configuration Management 
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CORBA Common Object Request Broker Architecture (OMG) 

EC Event channel (OMG) 

IDL Interface Definition Language (OMG) 

IS Information Service 

lOR Interoperable Object Reference 

NC Notification Channel (OMG) 

NE Network Element 

NV Name and Value pair 

EM Element Manager 

OMG Object Management Group 

QoS Quality of Service 

SS Solution Set 

UML Unified Modelling Language (OMG) 



4 Architectural features 

The overall architectural feature of Notification IRP is specified in 3GPP TS 32.302 [5]. This clause specifies features 
that are specific to the CORBA Solution Set (SS). 

4.1 Notification services 

In the CORBA Solution Set, notifications are emitted by IRP Agent using CORBA Notification service (OMG TC 
Document telecom [2]). 

CORBA Event service (OMG CORBA services [3]) provides event routing and distribution capabilities. CORBA 
Notification service provides, in addition to Event service, event filtering and support for Quality of Service (QoS) as 
well. 

A subset of CORBA Notification services shall be used to support the implementation of notification. This CORBA 
Notification service subset, in terms of OMG Notification service (OMG TC Document telecom [2]) defined methods, 
is identified in the present. 

4.1 .1 Support of Push and Pull Interface 

The IRP Agent shall support the OMG Notification push interface model. Additionally, it may support the OMG 
Notification pull interface model as well. 

4.1 .2 Support of multiple notifications in one push operation 

For efficiency, IRP Agent uses the following OMG Notification Service (OMG TC Document telecom [2]) defined 
interface to pack multiple notifications and push them to IRPManager using one method 

push_structured_events. The method takes as input a parameter of type EventBatch as defined in the OMG 
CosNotif ication module (OMG TC Document telecom [2]). This data type is a sequence of Structured Events 
(see clause 4). Upon invocation, this parameter will contain a sequence of Structured Events being delivered to 
IRPManager by IRP Agent to which it is connected. 

The maximum number of events that will be transmitted within a single invocation of this operation is controlled by 
IRP Agent wide configuration parameter. The amount of time IRP Agent will accumulate individual events into the 
sequence before invoking this operation is controlled by IRP Agent wide configuration parameter as well. 

IRP Agent may push EventBatch with only one Structured Event. 

The OMG Notification service (OMG TC Document telecom [2]) defined IDL module is shown below. 
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module CosNotifyComm { 

Interface SequencePushConsumer : Notif yPublish { 
void push_structured_events ( 

in CosNotif ication : : EventBatch notifications) 
raises ( CosEventComm: : Disconnected) ; 

}; // SequencePushConsumer 

}; // CosNotifyComm 

5 Mapping 

5.1 Operation mapping 

Notification IRP: IS (3GPP TS 32.302 [5]) defines semantics of operations visible across this IRP. These operations are 
the operations of the lOCs defined in [5]. 

Table 1 maps the operations defined in Notification IRP: IS (3GPP TS 32.302 [5]) to their equivalents (methods) in this 
Solution Set (SS). Specifically, the table 1 maps the operations of the lOCs defined in [5] to their equivalents in this 

SS. Sinceoneof the lOCs, the Notif icationIRP IOC, inherits from the ManagedGenericIRP IOC [4], the 
table 1 also maps the operations of ManagedGenericIRP IOC to their equivalents (methods) in this SS. 

The table 1 also qualifies if a method is Mandatory (M) or Optional (O) 

Table 1 : Mapping from IS Operation to SS Equivalents 



IS Operations in 
3GPP TS 32.302 [5] 


SS Methods 


Qualifier 


subscribe 


attach_push, attach_push_b, attach_pull 


M, 0, 


unsubscribe 


detach 


M 


getlRPVersion (see 
note. ) 


get_notif ication_IRP_version 


M 


get Subscript ion Statu 
s 


get_subscription_status 





get Subscript ion Ids 


get_subscription_ids 


O 


change Subs criptionFi 
Iter 


If subscription is estabHshed using attach_push method, the SS 
equivalent shall be change_subscription_f ilter . The IDL 
specification of this method is included in Annex A. This method is 
Optional (O). 

If subscription is estabUshed using attach_push_b method, the SS 
equivalent shall be modif y_constraints. The method is defined in 
OMG Notification Service Filter Interface (OMG TC Document telecom 
[2]). The IDL specification of this method is not included in Annex A. If 
IRP Agent supports the optional attach_push_b method, it shall 
support this method as mandatory. 

If subscription is estabHshed using attach_pull method, the SS 
equivalent shall be modif y_constraints. The method is defined by 
OMG Notification Service Filter Interface (OMG TC Document telecom 
[2]). The IDL specification of this method is not included in Annex A. If 
IRP Agent supports the optional attach_pull method, it shall support 
this method as mandatory. 


See box on 
the left. 


suspendSubscription 


If subscription is estabHshed using attach_push, there is no SS 
equivalent. In other words, IRPManager cannot suspend subscription. 

If subscription is estabHshed using attach_push_b, the SS equivalent 


See box on 
the left 
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shall be suspend_connection . This method is defined by OMG 
Notification Service (OMG TC Document telecom [2]). The IDL 
specification of this method is not included in Annex A. If IRP Agent 
supports the optional attach_push_b method, it shall support this 
method as mandatory. 

If subscription is estabUshed using attach_pull, there is no SS 
equivalent. 




resume Subscript ion 


If subscription is estabUshed using attach_push, there is no SS 
equivalent. In other words, IRPManager cannot resume subscription. 

If subscription is estabUshed using attach_push_b, the SS equivalent 
shall be resume_connection . This method is defined by OMG 
Notification Service (OMG TC Document telecom [2]). The IDL 
specification of this method is not included in Annex A. If IRP Agent 
supports the optional attach_push_b method, it shaU support this 
method as mandatory. 

If subscription is estabUshed using attach_pull, there is no SS 
equivalent. 


See box on 
the left 


getNotif icationCateg 
ories 


get_notif ication_categories 





getOperationProf ile 
(see note.) 


get_notif ication_I RP_ope rati on_prof ile 





getNotif icationProfi 
le (see note.) 


get_notif ication_IRP_notif ication_prof ile 






Note: These 3 operations are operations of ManagedGenericIRP IOC specified in [4]. The Notif icationIRP 
IOC of [5] inherits from it. 

5.2 Operation parameter mapping 

3GPP TS 32.302 [5] defines semantics of parameters carried in operations across the Notification IRP. Table 2 through 
table 14 indicate the mapping of these parameters, as per operation, to their equivalents defined in this SS. 

Table 2: Mapping from IS subscribe parameters to SS attach_push equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


manager Reference 


string manager_ref erence (see NOTE 1) 


M 


timeTick 


long time_tick 





notification 
Categories 


Notif icationlRPConstDefs : :Notif icationCategorySet 
notif ication_category_set 





filter 


string filter (see NOTE 2) 





subscript ionid 


Return value of type 

Notif IcationlRPConstDefs : : Subscript ionId 


M 


status 


Attach, ParameterNotSupported, InvalidParameter, 

Already Subscribed, 

At Least OneNotificationCategoryNot Supported 


M 
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NOTE 1: IRPManager creates a CosNotifyComm: : SequencePushConsumer object and invokes 

CORBA: : ORB : : ob ject_to_string to obtain the stringified lOR, say si. IRPManager stores the si. IRPManager 
sends si as input parameter of attach_push to IRP Agent. IRP Agent receives si, performs 

CORBA: : ORB : : string_to_ob ject to obtain the IRPManager's lOR and uses it for its future methods. IRP Agent 
also stores the si for future comparisons. IRPManager later calls detach with si. IRP Agent receives the stringified lOR 
si, compares it with those stored stringified lORs (e.g., si), finds a match, and performs the detach process. IRP Agent 
pushes sequence of Structured Events towards IRPManager via the CosNotifYComm: : SequencePushConsumer 
object push_structured_events method, depending on the supplied notification categories and filter. 
NOTE 2: The grammar of the filter string is extended_TCL defined by OMG Notification Service (OMG TC Document telecom 
[2]). This SS and the Alarm IRP: CORBA SS [10] shall use this grammar only.. 



Table 3: Mapping from IS subscribe parameters to SS attach_push_b equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


managerRef erence 


string manager_ref erence (see NOTE 1) 


M 


timeTick 


long time_tick 





notification 
Categories 


Notif icationlRPConstDef s : : Notif icationCategorySet 
notif ication_category_set 





filter 


string filter (see NOTE 2) 





subscript ionid 


Return value of type 

Notif icationlRPConstDef s : : Subscriptionid 


M 


Not specified in IS 


CosNotifyChannelAdmin : : SequenceProxyPushSupplier 
system_ref erence (see NOTE 3) 


M 


status 


Attach, OperationNotSupported, 
ParameterNot Supported, InvalidParameter, 
Already Subscribed, 
At Least OneNotificationCategoryNot Supported 


M 


NOTE 1: IRPManager creates a CosNotifyComm: : SequencePushConsumer object and invokes 

CORBA: : ORB : : ob ject_to_string to obtain the stringified lOR, say si. IRPManager stores the si. IRPManager 
sends si as input parameter of attach_push_b to IRP Agent. IRP Agent receives si and stores the si for future 
comparisons. IRPManager later calls detach with si. IRP Agent receives the stringified lOR si, compares it with those 
stored stringified lORs (e.g., si), finds a match, and performs the detach process. 

NOTE 2: The grammar of the filter string is extended_TCL defined by OMG Notification Service (OMG TC Document telecom 
[2]). This SS and the Alarm IRP: CORBA SS [10] shall use this grammar only. 

NOTE 3: IRP Agent provides this reference to which IRPManager can invoke methods to manage the subscription. Valid methods 
are not defined in this IRP. OMG CORBA Notification Service defines these methods. Read interface 
CosNotifyChannelAdmin: : SequenceProxyPushSupplier and 
CosNotifyComm: : SequencePushConsumer. IRPManager is expected to invoke 
connect_sequence_push_consumer method of this interface to connect its own 

CosNotifyComm: : SequencePushConsummer with this reference. After successful connection, IRP Agent pushes 
sequence of Structured Events towards IRPManager. 



Table 4: Mapping from IS subscribe parameters to SS attach_pull equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


managerRef erence 


string manager_ref erence (see NOTE 1) 


M 


timeTick 


long time_tick 





notification 
Categories 


Notif IcationlRPConstDef s : :Notif IcationCategorySet 
notif ication_category_set 





filter 


string filter (see NOTE 2) 





subscriptionid 


Return value of type 

Notif IcationlRPConstDef s : : Subscriptionid 


M 


Not specified in IS. 


CosNotifyChannelAdmin : : SequenceProxyPullSupplier 
system_ref erence (see NOTE 3) 


M 


status 


Attach, OperationNotSupported, 
ParameterNot Supported, InvalidParameter, 
Already Subscribed, 
At LeastOneNotificationCategoryNot Supported 


M 
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NOTE 1: IRPManager creates a CosNotifyComm: : SequencePullConsumer object and invokes 

CORBA: :ORB: : object_to_string to obtain the stringified lOR, say si. IRPManager stores the si. IRPManager 
sends si as input parameter of attach_pull to IRP Agent. IRP Agent receives si and stores the si for future 
comparisons. IRPManager later calls detach with si . IRP Agent receives the stringified lOR si, compares it with those 
stored stringified lORs (e.g., si), finds a match, and performs the detach process. 

NOTE 2: The grammar of the filter string is extended_TCL defined by OMG Notification Service (OMG TC Document telecom 
[2]). This SS and the Alarm IRP: CORBA SS [10] shall use this grammar only. 

NOTE 3: IRP Agent provides this reference to which IRPManager can invoke methods to manage the subscription. Valid methods 
are not defined in this IRP. OMG CORBA Notification Service defines these methods. Read interface 
CosNotif yChannelAdmin : : SequenceProxyPullSupplier and 
CosNotifyComm: : SequencePullConsumer. IRPManager is expected to invoke 
connect_sequence_pull_consumer method of this interface to connect its own 

CosNotifyComm: : SequencePullConsummer with this reference. After successful connection, IRPManager 
pulls sequence of Structured Events from IRP Agent. 



Table 5: Mapping from IS unsubscribe parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


manager Reference 


string manager_ref erence 


M 


subscriptionid 


Notif icationlRPConstDef s : : Subscriptionid 
subscript ion_id 





status 


Detach, InvalidParameter 


M 



Table 6: Mapping from IS getiRPVersion parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


versionNumberList 


Return value of type CommonlRPConstDef s : : VersionNumberSet 


M 


status 


GetNotificationlRPVersion 


M 



Table 7: Mapping from IS getsubscriptionstatus parameters to SS equivalents 



IS Operation 
parameter 


SS Method parameter 


Qualifier 


subscriptionid 


Notif icationlRPConstDef s : : Subscriptionid subscription_id 


M 


notif icationCa 
tegoryList 


Return value of type 

Notif icationlRPConstDef s : : Notif icationCategorySet 


M 


filterlnEffect 


string f ilter_in_ef f ect 





subscript ion St 
ate 


Not if icationlRPConstDef: : SubscriptionState 
subscription_state 





timeTick 


long time_tick 





status 


Getsubscriptionstatus, OperationNotSupported, InvalidParameter 


M 



Table 8: Mapping from IS getSubscriptionids parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


managerRef erence 


string manager_ref erence 


M 


subscriptionldList 


Return value of type 

Notif icationlRPConstDef s : : SubscriptionldSet 


M 


status 


GetSubscriptionids, OperationNotSupported, InvalidParameter 


M 



Table 9: Mapping from IS changeSubscriptionFilter parameters to SS equivalents 



IS Operation 
parameter 


SS Method parameter 


Qualifier 


subscriptionid 


Notif IcationlRPConstDef s : : Subscriptionid subscription_id 


M 


filter 


string filter 


M 


status 


ChangeSubscriptionFilter, OperationNotSupported, InvalidParameter 


M 



£75/ 



3GPP TS 32.303 version 4.0.0 Release 4 



12 



ETSI TS 132 303 V4.0.0 (2001-06) 



Table 10: Mapping from IS suspendSubscription parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


subscriptionid 


If subscription is established using attach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is estabUshed using attach_push_b, the SS equivalent method is 

suspend_connection. This method is defined by OMG Notification Service 

(OMG TC Document telecom [2]) and requires no parameter. Therefore, there 

is no SS equivalent for this IS parameter. 

If subscription is established using attach_pull, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 


M 


status 


If subscription is established using attach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is established using attach_push_b, the SS equivalent method is 

suspend_connection. This method is defined by OMG Notification Service 

(OMG TC Document telecom [2]) and it returns a void. Therefore, there is no 

SS equivalent for this IS parameter. This suspend_connection method can raise 

OMG Notification Service (OMG TC Document telecom [2]) defined exception 

called Connect ionAl ready Inactive. 

If subscription is established using attach_pull, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 


M 



Table 11 : Mapping from IS resumeSubscription parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


subscriptionid 


If subscription is estabUshed using attach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is established using attach_push_b, the SS equivalent method is 

resume_connection. This method is defined by OMG Notification 

Service (OMG TC Document telecom [2]) and requires no parameter. 

Therefore, there is no SS equivalent for this IS parameter. 

If subscription is estabUshed using attach_pull, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 


M 


status 


If subscription is estabUshed using attach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is estabUshed using attach_push_b, the SS equivalent 

method is resume_connection. This method is defined by OMG 

Notification Service (OMG TC Document telecom [2]) and returns a void. 

Therefore, there is no SS equivalent for this IS parameter. This 

resume_connection method can raise OMG Notification Service (OMG 

TC Document telecom [2]) defined exception called 

Connect ionAlreadyActive. 

If subscription is estabUshed using attach_pull, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 


M 



Table 12: Mapping from IS getNotificationCategories parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


notif icationCateg 
oryList 


Return value of type 

Notif icationlRPConstDefs : : Notif icationCategorySet 


M 


eventTypeList 


NotificationlRPConstDefs: : Event Types Set 
event_type_list 





extendedEventType 

List 


NotificationlRPConstDefs: : Ext endedEvent Types Set 
extended_event_type_list 





status 


GetNotificationCategories, Ope rat ionNot Supported 


M 
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Table 13: Mapping from IS getOperationProf ile parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


iRPVersion 


ManagedGenericIRPConstDef s : : VersionNumber 
notif ication_irp_version 


M 


operationNameProf 
ile, operationPara 
meterProf ile 


Return of type ManagedGenericIRPConstDef s : :MethodList 


M 


status 


GetNotif icationlRPOperationsProf ile, OperationNotSupp 
orted, InvalidParameter 


M 



Table 14: Mapping from IS getNotificationProfile parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


iRPVersion 


ManagedGenericIRPConstDef s : : VersionNumber 
notif ication_irp_ver s ion 


M 


notif icationNameP 
rofile,notificati 
onParameterProf 11 
e 


Return value of type ManagedGenericIRPConstDef s : :MethodList 


M 


status 


GetNotif icationlRPNot 1 float ionProf ile, OperationNotSu 
pported, InvalidParameter 


M 



5.3 Parameter mapping 



Notification IRP: IS (3GPP TS 32.302 [5]) defines the semantics of common attributes carried in notifications. This SS 
does not provide the mapping of these attributes to their CORBA SS equivalents. Other IRPs such as Alarm IRP: 
IS (3GPP TS 32. 1 1 1-2 [6]) identify and qualify these common attributes for use in their environment. Their 
corresponding SS documents define the mapping of these attributes to their SS equivalents. 



6 



IRPAgent's Behaviour 



This clause describes some IRPAgent's behaviour not captured by IDL. 



6.1 Subscription 



IRPManager can invoke multiple at tach_push, multiple attach_push_b or multiple attach_pull using 
different manager_ref erence(s). As far as IRP Agent is concerned, the IRP Agent will emit notifications to 
multiple "places" with their independent filter requirements. IRP Agent will not know if the notifications are going to 
the same IRPManager. 

If IRPManager invokes multiple at tach_push, attach_push_b or attach_pull using the same 
manager_ref erence and with an already subscribed notif ication_category, IRP Agent shall raise 
AlreadySubscribed exception to all invocations except one. 

IRPManager can invoke multiple attach_push using the same manager_ref erence and with one or more not- 
yet-subscribed notif ication_categories. In this case, if IRP Agent supports all the notification categories 
requested, IRP Agent shall accept the invocation; otherwise, it raises 
AtLeastOneNotif IcationCategoryNotSupported exception. IRP Agent shall have similar behaviour for 

attach_push_b and attach_pull. 
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When IRPManager is in subscription by invoking attach_push, IRPManager can change the filter constraint, using 
change_subscription_f ilter, appHcable to the notification categories specified in the attach_push. 

When IRPManager is in subscription by invoking attach_push_b, IRPManager can change the filter constraint 
during subscription using the OMG defined Notification Service Filter Interface. IRPManager shall not use 

change_subscription_f ilter; otherwise it shall get an exception. 

6.2 IRPAgent supports multiple categories of Notifications 

IRP Agent may emit multiple categories of Notifications. IRPAgent may have mechanism for IRPManager to pull for 
notifications of multiple categories. 

IRPManager can query IRPAgent about the categories of notifications supported by using 

get_notif ication_categories. 

IRPManager uses a parameter, notif ication_categories, in attach_push, attach_push_b and 
attach_pull to specify one or more categories of notifications wanted. 

IRPManager uses a zero-length sequence in notif ication_categories of attach_push, attach_push_b 
and attach_pull to specify that all IRPAgent supported categories of notifications are wanted. If IRPManager uses 
attach_push with zero-length sequence in notif ication_categories and if the operation is successful, 
IRPAgent shall reject subsequent attach_push operation, regardless if the notif ication_categories 
contains a zero-length sequence or one or more specific notification categories. IRPAgent shall have similar behaviour 
for attach_push_b and attach_pull. 

6.3 IRPAgent's integrity risk of attach_push_b Method 

In the case that IRPAgent implements this method by extending or using OMG compliant Notification Service, the 
following IRPManager behaviour illustrates a risk to IRPAgent's integrity. 

Given the object reference (lOR) of the SequenceProxyPushSupplier (as the mandatory output parameter of the 
subject method), IRPManager can invoke SequenceProxyPushSupplier. MyAdmin method. 

IRPManager can then obtain the consumer admin object of the proxy. Then IRPManager can invoke 
ConsumerAdmin.MyChannel to get the lOR of the Notification Channel. IRPManager then can call 
EventChannel .MyFactory which will provide IRPManager the lOR of the Event ChannelFactory itself. 
IRPManager can then able to invoke methods directly on the EventChannelFactory, like get_all_channels 
which lists all channel numbers and create_channel which allows IRPManager to create any number of additional 
channels. 

A malicious IRPManager can, given access to the EventChannelFactory, get a list of existing channels and start 
connecting them together at random thus compromising the IRPAgent's integrity. Deployment of this 
attach_push_b needs strong authentication and authorisation mechanism in place. 

The attach_push is mandatory. IRPAgent compliant to this IRP shall support it. 

The attach_push_b is optional. It is recommended that IRPAgent concerned with integrity risk should not support 
the attach_push_b option. 



6.4 Quality of Service Parameters 



The OMG Notification Service [2] supports a variety of Quality of Service (QoS) properties, such as reliability and 
priority, that may be expressed to indicate the delivery characteristics of notifications. The following OMG 
Notification Service QoS parameter settings shall be required when the IRPAgent uses the OMG Notification Service to 
support this SS: 

1 . The order policy shall be set to FifoOrder (First-in, First-out) [2] . 

2. The message priority shall be set to 0, i.e., no priority [2]. 
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3. The Start Time Supported shall be set to false, i.e., do not use Start Time [2]. 

4. The Stop Time Supported shall be set to false, i.e., do not use Stop Time [2]. 

When the OMG Notification Service is not used, the IRP Agent shall provide First-in, First-out notification ordering 
not provide message priority and not provide the support of Start Time and Stop Time. 



£75/ 



3GPP TS 32.303 version 4.0.0 Release 4 16 ETSI TS 132 303 V4.0.0 (2001-06) 



Annex A (normative): 
Notification IRP CORBA IDL 

#include "TimeBase . idl" 

#ifndef ManagedGenericIRP_idl 
#define ManagedGenericIRP_idl 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: ManagedGenericIRPConstDef s 

This module contains definitions commonly used among all IRPs such as Alarm IRP. 

V 

module ManagedGenericIRPConstDef s 

{ 

/* 

Definition imported from CosTime. 

The time refers to time in Greenwich Time Zone. 

It also consists of a time displacement factor in the form of minutes of 

displacement from the Greenwich Meridian. 

V 

typedef TimeBase :: UtcT IRPTime; 

enum Signal {OK, Failure, PartialFailure } ; 

/* 

The VersionNumber is a string that identifies the IRP specification name 
and its version number. See definition "IRP document version number 
string" or "IRPVersion" . 

The VersionNumberSet is a sequenece of such VersionNumber. It is returned 

by get_XXX_IRP_versions ( ) . The sequence order has no significance. 

V 

typedef string VersionNumber; 

typedef sequence <VersionNumber> VersionNumberSet; 

typedef string MethodName; 

typedef string ParameterName; 

typedef sequence <ParameterName> ParameterList ; 

/* 

The Method defines the structure to be returned as part of 

get_supported_operations_prof ile ( ) . The name shall be the actual method 

name (ex. "attach_push" , "change_subscription_f liter" , etc.) 

The parameter_list contains a list of strings. Each string shall be 

the actual parameter name (ex. "manager_ref erence" , "filter", etc.) 

V 

struct Method 

{ 

MethodName name; 

ParameterList parameter_list ; 

}; 

/* 

List of all methods and their associated parameters. 
V 
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typedef sequence <Method> MethodList ; 
}; 

/* ## Module: ManagedGenericIRPSystem 

This module contains definitions conunonly used among all IRPs such as Alarm IRP. 

V 

module ManagedGenericIRPSystem 

{ 

/* 

Exception thrown when an unsupported optional parameter 

is passed with information. 

The parameter shall be the actual unsupported parameter name. 

V 

exception ParameterNotSupported { string parameter; } ; 

/* 

Exception thrown when an invalid parameter value is passed. 

The parameter shall be the actual parameter name. 

V 

exception InvalidParameter { string parameter; }; 

/* 

Exception thrown when an unsupported optional method is called. 

V 

exception OperationNotSupported {}; 

}; 

#endif 



# include "CosNotif yChannelAdmin . idl" 
#include "generic . idl" 

#ifndef Notif icationIRP_idl 
#define Notif icationIRP_idl 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: Notif icationlRPConstDefs 

This module contains definitions specific for Notification IRP. 

V 

module Notif IcationlRPConstDefs 

{ 

/* 

Define the current Notification IRP version. 

This string is used for the return value of 

get_Notif ication_IRP_versions () . 

It should be updated based on the rule of sub-clause 

titled "IRP document version number string". 

V 

const string NOTIFICATION_IRP_VERSION = "<to be updated using the rule>"; 

/* 

Define the parameters (in the notification header) specified in 

the Notification IRP: IS. 

V 
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interface AttributeNameValue 
{ 

const string NOTIFICATION_ID = "a"; 

const string EVENT_TIME = "b"; 

const string SYSTEM_DN = "c"; 

const string MANAGED_OBJECT_CLASS = "d"; 

const string MANAGED_OBJECT_INSTANCE = "e"; 

}; 

/* 

It defines the notification categories. 

A notification category is identified by the IRP name and its version number. 

V 

typedef ManagedGenericIRPConstDef s : : VersionNumberSet Notif icationCategorySet ; 

/* 

It defines the notification types of a particular notification category. 

V 

typedef sequence <string> Notif icationTypePerNotificationCategory; 

/* 

This sequence identifies all notification types of all notification 
categories identified by Notif IcationCategorySet . The number of elements 
in this sequence shall be identical to that of Notif IcationCategorySet . 
V 

typedef sequence <Notif IcationTypePerNotif icationCategory> 
Notif IcationTypesSet; 

/* 

It defines a sequence of Subscriptionlds . 

V 

typedef string Subscriptionid; 

typedef sequence <SubscriptionId> SubscriptionldSet ; 

/* 

This indicates if the subscription is Active (not suspended) , Suspended, 

or Invalid. 

V 

enum SubscriptionState {Active, Suspended, Invalid}; 

}; 



/* ## Module: Notif icationlRPSystem 

This module implements capabilities of Notification IRP. 

V 

module Notif icationlRPSystem 

{ 

/* 

System fails to complete the operation. System can provide reason 

to qualify the exception. The semantics carried in reason 

is outside the scope of this IRP. 

V 

exception GetNotif icationlRPVersions { string reason; }; 

exception GetNotif icationlRPOperationsProf lie { string reason; }; 

exception GetNotif icationlRPNotificationProf lie { string reason; }; 

exception Attach { string reason; }; 

exception DetachException { string reason; }; 

exception GetSubscriptionStatus { string reason; }; 



£75/ 



3GPP TS 32.303 version 4.0.0 Release 4 19 ETSI TS 132 303 V4.0.0 (2001-06) 



exception ChangeSubscriptionFilter { string reason; } ; 
exception GetNotif icationCategories { string reason; }; 
exception SuspendSubscription { string reason; }; 
exception ResumeSubscription { string reason; }; 
exception GetSubscriptionlds { string reason; }; 

exception AlreadySubscribed { } ; 

exception AtLeastOneNotif icationCategoryNotSupported {}; 

interface Notif icationIRP 
{ 

/* 

Return the list of all supported Notification IRP versions. 

V 

ManagedGenericIRPConstDef s : : VersionNumberSet get_notif ication_IRP_versions 

( 

) 

raises (GetNotif icationlRPVersions) ; 

/* 

Return the list of all supported operations and their supported 

parameters for a specific Notification IRP version. 

V 

ManagedGenericIRPConstDef s : : MethodList 

get_notif ication_IRP_operations_prof lie ( 

in ManagedGenericIRPConstDef s : : VersionNumber 
notif ication_irp_vers ion 
) 
raises (GetNotif icationlRPOperationsProf lie, 

ManagedGenericIRPSystem: : Ope r at ionNot Supported, 

ManagedGenericIRPSystem: : InvalidParameter ) ; 

/* 

Return the list of all supported notifications. 

Agent should always throw a ManagedGenericIRPSystem: : OperationNotSupported 

exception . 

Similar method, such as get_alarm_IRP_notif ication_prof lie, 

is supported in other IRP versions such as Alarm IRP. 

V 

ManagedGenericIRPConstDef s : : MethodList 

get_notif ication_IRP_notif ication_prof lie ( 

in ManagedGenericIRPConstDef s : : VersionNumber 
notif ication_irp_vers ion 
) 
raises (GetNotif icationlRPNot if icationProf lie, 

ManagedGenericIRPSystem: : OperationNotSupported, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Obtain the list of all supported notification categories. 

V 

Notif icat ion IRPConstDefs : : Notif icationCat ego rySet 

get_notif ication_categories ( 

out Notif icationlRPConstDef s : : Notif icationTypesSet 
notif icat ion_type_li St 
) 
raises (GetNotif icationCategories, 

ManagedGenericIRPSystem: : OperationNotSupported) ; 

Notif IcationlRPConstDef s :: Subscriptionid attach_push ( 
in string manager_ref erence. 
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in unsigned long time_tick, 

in Notif icationlRPConstDef s : :Notif icationCategorySet 

notif ication_categories, 
in string filter 
) 
raises (Attach, ManagedGenericIRPSystem: : ParameterNotSupported, 

ManagedGenericIRPSystem: : InvalidParameter , AlreadySubscribed, 
At LeastOneNotificationCategoryNot Supported) ; 

Notif IcationlRPConstDef s :: Subscriptionid attach_push_b ( 
in string manager_ref erence, 
in unsigned long time_tick, 
in Notif IcationlRPConstDef s : : Notif icationCategorySet 

notif ication_categories, 
in string filter, 

out CosNotif yChannelAdmin : : SequenceProxyPushSupplier system_ref erence 
) 

raises (Attach, ManagedGenericIRPSystem: : OperationNotSupported, 
ManagedGenericIRPSystem: : ParameterNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter, 
AlreadySubscribed, At LeastOneNotificationCategoryNot Supported) ; 

Notif IcationlRPConstDef s :: Subscriptionid attach_pull ( 
in string manager_ref erence, 
in unsigned long time_tick, 
in Notif IcationlRPConstDef s : : Notif IcationCategorySet 

notif ication_categories, 
in string filter, 

out CosNotif yChannelAdmin : : SequenceProxyPullSupplier system_ref erence 
) 

raises (Attach, ManagedGenericIRPSystem: :OperationNotSupported, 
ManagedGenericIRPSystem: : ParameterNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter, 
AlreadySubscribed, AtLeastOneNotif icationCat ego ryNot Supported) ; 

/* 

Replace the present filter constraint with the one provided. 

V 

void change_subscription_f liter ( 

in string subscription_id, 

in string filter 

) 

raises (ChangeSubscriptionFilter, 

ManagedGenericIRPSystem: : OperationNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter ) ; 

/* 

Check the current state of the subscription. 
V 

Notif icationlRPConstDef s : : Notif IcationCategorySet get_subscription_status 
( 

in string subscription_id, 

out string f ilter_in_ef f ect , 

out Notif icationlRPConstDef s : : SubscriptionState subscription_state, 

out long time_tick 
) 
raises (GetSubscriptionStatus, 

ManagedGenericIRPSystem: : OperationNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter ) ; 

Notif IcationlRPConstDef s : : SubscriptionldSet get_subscription_ids ( 
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in string manager_ref erence 

) 

raises (GetSubscriptionlds, 

ManagedGenericIRP System: : Ope r at ionNot Supported, 
ManagedGenericIRPSystem: : InvalidParameter ) ; 

/* 

Suspends the event flow until a resume is issued. 

V 

void suspend_subscription ( 

in string subscription_id 
) 
raises (SuspendSubscription, 

ManagedGenericIRPSystem: : OperationNotSupported) ; 

/* 

Resumes the event flow if it was suspended. 

V 

void resume_subscription ( 

in string subscription_id 
) 
raises (ResumeSubscription, 

ManagedGenericIRPSystem: : OperationNotSupported) ; 

/* 

Terminates the subscription with the agent. 

V 

void detach ( 

in string manager_ref erence, 

in string subscription_id 
) 
raises (DetachException) ; 



}; 

#endif 
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